From: Tim Janik <timj@src.gnome.org>
Date: Fri, 20 Jun 2008 11:10:14 +0000 (+0000)
Subject: Change docs and signature of gtk_widget_get_allocation
X-Git-Tag: archive/raspbian/4.4.1+ds1-2+rpi1~1^2~428^2^2~31839
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=bf2323b1ded6061928018b9fe28a10e77af3ff23;p=gtk4.git

Change docs and signature of gtk_widget_get_allocation

svn path=/trunk/; revision=20625
---

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 790d244b9b..6b5c49fcf3 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -677,8 +677,7 @@ gtk_widget_class_init (GtkWidgetClass *klass)
   /**
    * GtkWidget:window:
    *
-   * The widget's window or its parent window if it does not have a
-   * window (as indicated by the GTK_NO_WINDOW flag).
+   * The widget's window if it is realized, %NULL otherwise.
    *
    * Since: GSEAL-branch
    */
@@ -686,7 +685,7 @@ gtk_widget_class_init (GtkWidgetClass *klass)
 				   PROP_WINDOW,
 				   g_param_spec_object ("window",
  							P_("Window"),
-							P_("The widget's window or its parent window"),
+							P_("The widget's window if it is realized"),
 							GDK_TYPE_WINDOW,
 							GTK_PARAM_READABLE));
 
@@ -9890,30 +9889,27 @@ gtk_widget_get_has_tooltip (GtkWidget *widget)
 /**
  * gtk_widget_get_allocation:
  * @widget: a #GtkWidget
- * @allocation: a #GtkAllocation
  *
- * Fills @allocation with the widget's allocation as provided by its parent.
+ * Retrieves the widget's allocation.
+ *
+ * Return value: widget's allocation
  *
  * Since: GSEAL-branch
  */
-void
-gtk_widget_get_allocation (GtkWidget     *widget,
-                           GtkAllocation *allocation)
+GtkAllocation
+gtk_widget_get_allocation (GtkWidget *widget)
 {
-  g_return_if_fail (GTK_IS_WIDGET (widget));
-  g_return_if_fail (allocation != NULL);
+  GtkAllocation allocation;
+  g_return_val_if_fail (GTK_IS_WIDGET (widget), allocation);
 
-  allocation->x = widget->allocation.x;
-  allocation->y = widget->allocation.y;
-  allocation->width = widget->allocation.width;
-  allocation->height = widget->allocation.height;
+  return widget->allocation;
 }
 
 /**
  * gtk_widget_get_window:
  * @widget: a #GtkWidget
  *
- * Returns the widget's window or the parent window.
+ * Returns the widget's window if it is realized, %NULL otherwise
  *
  * Return value: @widget's window.
  *
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index cbf070e034..dfc423e900 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -572,8 +572,7 @@ void                  gtk_widget_set_parent_window      (GtkWidget    *widget,
 void                  gtk_widget_set_child_visible      (GtkWidget    *widget,
 							 gboolean      is_visible);
 gboolean              gtk_widget_get_child_visible      (GtkWidget    *widget);
-void		      gtk_widget_get_allocation         (GtkWidget    *widget,
-							 GtkAllocation*allocation);
+GtkAllocation	      gtk_widget_get_allocation         (GtkWidget    *widget);
 GdkWindow*            gtk_widget_get_window             (GtkWidget    *widget);
 
 GtkWidget *gtk_widget_get_parent          (GtkWidget           *widget);